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2 
3 

4 CIM-WMI TRANSLATOR 

5 
6 

7 BACKGROUND OF THE INVENTION 

8 

9 1. Field of the Invention: 

^ 10 The present invention relates generally to management software in a client-server 

G 11 environment, and, more particularly, relates to translating first information formatted in 

fy 12 Common Information Model/Extensible Markup Language (CIM/XML) received by the 

'■4 13 server from the client into second information in format compatible with Windows 

y 14 Management Interface (WMI), and translating vice-versa. 

1 ^5 

2 16 2. Description of Prior Art: 

17 The computer industry is evolving rapidly. Certain companies may have emerged 

18 as front-runners within that industry in their respective sectors. Those sectors include: 

19 semiconductor and semiconductor-equipment manufacturing, processor development, 

20 networking, storage systems, operating system software, application software, etc. This 

21 is an on-going competition and any current front-runner may have to accept secondary 

22 status tomorrow. One result of this vigorous competitive activity is that proprietary 

23 designs frequently emerge from one company which are not compatible with 

24 technological-designs of other companies. Accordingly, industry standards committees 



2 



Assignee docket No: EMC-01-027; Attorney docket No, JW-EMC-008 PATENT 

1 have evolved to try to bring uniformity to these different developmental directions where 

2 possible. One such committee is known as Distributed Management Task Force (DMTF) 

3 and has generated a particular standard called Web Based Enterprise Management 

4 (WBEM), This is a standard which certain industry participants want to meet, including 

5 those participants in distributed management software (for computer storage systems and 

6 storage area networks -SANs). A ninety-seven (97) page specification entitled 

7 "Common Information Model (CIM) Specification" Version 2.2, dated June 14, 1999 

8 prepared by DMTF offers more information about this subject and is incorporated by 

n 9 reference herein in its entirety; electronic copies of this specification can be obtained free 

m 10 of charge from the Internet at ftp://ftp.dmtf org or htt p://www.dmtf org . Another 

11 specification of eighty-seven (87) pages entitled "Specification for CIM Operations of 

W 12 HTTP" Version 1 ,0, dated August 1 1^ 1 999, prepared by DMTF likewise provides 

™ 13 valuable background information and is also incorporated by reference herein in its 

•L-i ■ 

14 entirety, (HTTP means Hyper Text Transfer Protocol). 

O 15 

16 In this context, consider software offered by the Microsoft company which 

17 designs, develops and markets many different software components. With specific 

18 reference to two such components, namely, its Internet Information Server (IIS) and its 

19 Windows Management Instrumentation Common Information Model Object Manager 

20 (WMI CIMOM), these are two independent, object-oriented software components. Each 

21 component is marketed separately from the other and each provides separate usefixl 

22 software fimctions. More information will be supplied about these two software 

23 components hereinbelow, after a brief discussion on the subject of software objects. 
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1 

2 An object, in computer software terms, is a dedicated area of memory which can 

3 be thought of as an impervious container holding both data and instructions within itself, 

4 both defining itself and its relationships to other objects in the computer system or 

5 network. An object can send and receive messages to and from other objects, respond 

6 and react to such messages (e.g. commands) but shall normally be impervious to internal 

7 scrutiny. For example, in a storage processor (a kind of computer) each object may 

8 describe or relate to a specific detail in the processor (e.g. a fan, power switch, cache 

9 memory, power supply, disk drive interface, etc.), where these tangible objects in the 
IS 10 storage processor can send messages to each other and to other objects outside the 

%Jl 11 processor. The relationship between these specific objects in the storage processor is 

m 12 usually visualized or characterized as a "tree" of objects. In a tree, each such object 

^ 13 hangs off a preceding object as if in a parent-child or inherhance relationship, with many 

H: 14 children hanging from a parent not being an atypical configuration. In addition to these 

15 tangible kinds of objects, logical units (LUNs) are other nodes or objects that can be 

16 contained within the tree. 

17 

18 Certain purchasers (OEM manufacturers) of these IIS and WMI software 

19 components can use either one or both in computer-related systems developed and 

20 marketed to end-users by such purchasers. However each one of these software 

21 components separately does not meet the standards established by WBEM - each is not 

22 WBEM-compliant for various reasons including that each component currently uses 

23 Distributed Component Object Model (DCOM) to support objects distributed across a 
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1 network instead of the WBEM-established standard of Extensible Markup Language 

2 (XML) to perform that same support ftinction, ahhough IIS does have some compatibility 

3 with XML. 
4 

5 Thus, there is a need amongst certain industry participants, including computer 

6 storage companies that supply distributed storage management software utilizing both of 

7 these IIS and WMI CIMOM software components in a client-server environment, to have 

8 both components meet the WBEM standard. The standard must be met in an efficient 

9 manner that does not negatively impact the participants' respective proprietary designs. 

10 Distributed storage management software normally runs on the client or user interface 

1 1 (UI) computer while, at the same time, it is also deployed and running as agent software 

12 on various network nodes such as servers. Servers can be connected between the client 

13 computer and the storage systems, or can be connected in the storage systems themselves 

14 or in the SANs. Accordingly, distributed storage management software can be run as 

15 agent software on storage processors (yet other computers) within such storage systems 

16 or SANs. 
17 

18 One prior art approach to meeting the WBEM standard is to write client software 

19 so it supports multiple communication protocols such as CIM/XML/HTTP on the one 

20 hand and DCOM on the other hand. This approach allows Windows clients the ability to 

21 access CIM data through WMI over DCOM. WMI is specific to Microsoft's Windows 

22 product and uses DCOM as its communication protocol. This approach is not open to 

23 other operating systems which do not support COM and WMI. Accordingly, this 
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1 approach is limited since it still only provides support for client computers running 

2 Windows software. Moreover, this brute-force approach to a solution presents a 

3 significant and costly development effort. Thus, a more elegant, generic and permanent 

4 solution is needed, with flexibility to accommodate virtually any communication 

5 protocol, and the welcome solution of the present invention satisfies this need. 
6 

7 SUMMARY OF THE INVENTION 

8 Embodiments of the present invention relate to apparatus, method, interface, 

9 and/or computer program product operating within a storage system employed in a client 
tfJ 10 server network to accomplish the following: First information is received in the storage 

1 1 system in accordance with a first communication protocol from the client. The first 

rli 

12 protocol is determined as acceptable to allow further processing of the first information in 

%-^^} 

, ' 13 the system. The first information is translated into second information compatible with a 

CP 14 second communication protocol An object manager operates in accordance with the 

S 15 second protocol. The second information is forwarded to the object manager and in 

16 response to the object manager managing the second information a managed response 

17 thereto is received. The managed response is reverse-translated into its equivalent 

18 response compatible with the first protocol. The equivalent response is forwarded to the 

19 client. 
20 

21 In an apparatus embodiment of the present invention, to be operated within a 

22 client-server network employing a storage area network including at least one storage 

23 system, the apparatus functions to interface between a first communication protocol and a 
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1 second communication protocol. The apparatus includes a first information receiver for 

2 receiving first information in accordance with the first protocol firom the client, a first 

3 protocol acceptor for determining that the first protocol is acceptable to allow further 

4 processing of the first information in the system, a first information translator for 

5 translating the first information into second information compatible with the second 

6 protocol, an object manager, for example WMI, operative in accordance with the second 

7 protocol, forwarding and receiving apparatus for forwarding the second information to 

8 the object manager and responsive to the object manager managing the second 

9 information for receiving a managed response thereto fi-om the object manager, a reverse 
5 10 translator for reverse-translating the managed response into an equivalent response 

'1 1 1 compatible with the first protocol, and an equivalent response forwarder for forwarding 

fj 12 the equivalent response to the client, 
s 13 

Co 14 In a computer program product embodiment of the present invention to be 

m 15 operated within a client-server network employing a storage area network including at 

^ 16 least one storage system, the computer program product functions to interface between a 

17 first communication protocol and a second communication protocol and comprises 

18 program code for accomplishing this function. 
19 

20 In a further feature of the present invention, the first protocol is WBEM' S 

2 1 CIM/XML/HTTP and the second protocol is WMI/DCOM. 

22 
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1 In yet an additional feature of the present invention, a plurality of acceptable 

2 protocols are established. The first protocol is compared against the plurality of 

3 acceptable protocols seriatim until the first protocol matches one of the plurality of 

4 protocols. In response to the comparison further processing is allowed. 
5 

6 It is thus advantageous to utilize embodiments of the present invention to 

7 automatically achieve communication protocol compatibility between client 

8 communication protocol and storage system communication protocol It is a &rther 

9 advantage to utilize embodiments of the present invention to automatically achieve 

m 10 communication protocol compatibility between any one of several client communication 

^ 1 1 protocols and any one of several storage system communication protocols. 

I y 

ffl 12 

13 It is thus a general object of the present invention to provide an improved storage 

J: 14 system within a client-server network. 

a 15 



16 It is another object of the present invention to provide improved storage 

17 management software usable on a storage system within a client server environment. 
18 

19 It is a further object of the present invention to resolve incompatibility between 

20 two incompatible communication protocols, 
21 

22 It is yet another object of the present invention to provide a translator within a 

23 computer storage system utilizing both CIM/XML and WMI communication protocols. 
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1 to translate therebetween in such a manner that operation of the storage system is not 

2 negatively impacted. 

3 

4 Other objects and advantages will be understood after referring to the detailed 

5 description of the preferred embodiments and to the appended drawings wherein: 

6 

7 BRIEF DESCRIPTION OF THE DRAWINGS 

8 Fig- 1 is a block diagram of a storage system within a client server environment of 

9 the type in which embodiments of the present invention may be utilized; 

O. 10 Fig. 2 is a schematic diagram of certain functional components contained within a 

/I 11 storage processor located within the storage system of Fig. 1; 

^ 12 Fig. 3 is a flowchart illustrating the algorithm employed by the present invention; 

' 13 Fig. 4 is a flowchart illustrating in more detail the algorithm employed by certain 

m 14 of the steps of Fig. 3 in translating from CIM/XML to WMI; and, 

O 

m 15 Fig. 5 is a flowchart illustrating in more detail the algorithm employed by certain 

^ 16 of the steps of Fig. 3 in reverse-translating from WMI to CIM/XML, 
17 

18 DESCRIPTION OF THE PREFERRED EMBODIMENTS 

19 Figure 1 - Client-Server Block Diagram 

20 In referring to Fig. 1, there is shown a block diagram of an exemplary storage 

21 system within a client server environment of the type in which embodiments of the 

22 present invention may be utilized. Client or User Interface (UI) 101 is shown connected 

23 by bidirectional bus 107 to public Local Area Network (LAN) bus 106. Also shown is 



9 



Assignee docket No: EMC-01-027; Attorney docket No. JW-EMC-008 PATENT 

1 storage system 104 containing two storage processors (SPA & SPB) 102 and 103 and a 

2 disk array 105 which could be of the Redundant Array of Independent Disks (RAID) 

3 type. The server or servers (not shown in this Figure) are software components located 

4 within the storage processors. Storage processors 102 and 103 are connected from LAN 

5 106 by bidirectional busses 108 and 109 respectively and are connected to disk drive or 

6 disk array 1 05 via two bidirectional busses 1 1 0 and 1 1 1 respectively. In addition, the two 

7 storage processors are interconnected within the storage system by way of bidirectional 

8 bus 1 12. More than two storage processors and more than one disk drive or disk array 

9 can be used with embodiments of the present invention and the specific configuration 

5 10 of Fig. 1 is for exemplary purposes only. Typically, all of these busses can be compatible 

M 1 1 with Small Computer System Interface (SCSI) or other Internet-compatible bus protocol. 

ffl 12 

J" 13 Fig. 1 further depicts storage area network (SAN) 1 17 which includes storage 

system 104, as well as servers 1 13 and 114. Server 1 13 is operatively coupled to storage 

15 processor 102 by way of bidirectional bus 1 1 5. Server 1 14 is operatively coupled to 

16 storage processor 103 by way of bidirectional bus 1 16. More than two storage area 

17 network servers could have been operatively coupled together with storage system 104, 

18 but only two are shown to enhance clarity of presentation. Servers 1 13 and 1 14 can serve 

19 client 101 through other connectivity (not shown) or could serve other clients (not 

20 shown) connected with this network and/or with other networks. UI 101 may select a 

21 single management point for managing storage system 104 or SAN 1 17 in accordance 

22 with disclosure of U.S. patent application Serial No.09/798571 filed March 3, 2001, 

23 entitled: "Single Management Point for a Storage System or Storage Area Network", 



CP 14 



10 



Assignee docket No: EMC-01-027; Attorney docket No. JW-EMC-008 PATENT 

1 having assignee common with that of this instant patent appUcation, and incorporated by 

2 reference herein in its entirety. 

3 

4 In operation, UI 101 forwards commands and data to SPA 102 and SPB 103 over 

5 bidirectional busses 107, LAN 106, 108 and 109. SPA 102 and SPB 103 interact via 

6 bidirectional bus 102 in a manner described in the incorporated by reference application 

7 where one or the other storage processor is the selected portal processor. Assume SPA 

8 102 is selected to be portal processor and process input from client 101 . Output of SPA 

9 102 via bus 110 to disk array 105, may be a command which either writes data into or 

10 reads data from disk array 105, or which commands certain of these disks to perform 

1 1 other appropriate tasks. If communication protocol supporting both the command from 

12 UI 101 and the return information from disk array 105 is compatible throughout the 

13 communication path, then information flow in both directions is accurate, allowing the 

14 required task to be carried-out to its final and accurate conclusion. However, if such 

15 protocol is not compatible throughout, under certain circumstances embodiments of the 

16 present invention can be utilized within the storage processors to automatically adjust for 

17 protocol differences by way of suitable translation operations in both directions (from 

18 Client to disk array and vice versa). Embodiments of the present invention have 

19 particular utility in facilitating information flow which would otherwise be inhibited 

20 because of protocol differences ascribed to CIM/XML on the one hand and to WPI on the 

21 other hand, to be described in more detail hereinbelow (designations "CIM/XML" and 

22 "XML/CIM" are intended to be identical and interchangeable herein). 
23 
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1 Figure 2 - Storage Processor Schematic 

2 Fig. 2 is a schematic diagram of certain functional software components contained 

3 within each storage processor located within the storage system of Fig. 1 . Bidirectional 

4 bus 108, shown in Figs 1 and 2, is operatively coupled to Internet Information Server 

5 (IIS) 20 1 . This server is a software component that runs on Microsoft' s Windows 

6 platforms. The output of IIS 20 lis operatively coupled to the input of Internet Server 

7 Application Programmer Interface (ISAPI) filter 202, and contained within that filter is 

8 Windows Management Interface (WMI) translator 203 . ISAPI enables programmers to 

9 develop Web-based appUcations that run faster than conventional Common Gateway 

10 Interface (CGI) programs. A filter in this context means a fimctional software component 

1 1 that can modify operation of the web server (IIS 20 1) itself At several points in the 

12 servicing of a request from a client, a server can call into each dynamic link library 

13 (DLL) of an ISAPI filter and allow each such DLL to have an opportunity to intervene in 

14 (or "filter") the processing of such request. The filter can override various actions which 

15 otherwise would have proceeded without such filtering. WMI translator 203 is software 

16 which receives an informational input in accordance with a first protocol, and in this 

17 example in accordance with CIM/XML protocol format, and translates that input into 

18 equivalent information represented by a second protocol, and in this example in 

19 accordance with WMI protocol format. The output of ISAPI filter 202 is operatively 

20 coupled by bidirectional bus 209 to the input of WMI object manager 204, the output of 

21 which is operatively coupled via bidirectional bus 210 to other software components that 

22 are needed to operate disk drives 105. 
23 
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1 These other software components are: provider(s) 205, RAID++ 206, and flare 

2 code 207. A WMI provider is an object-oriented database that provides data about 

3 appUcations, devices, and other sources of system information. Unlike a standard 

4 relational database, it supports classes, instances of those classes, and inheritance 

5 relationships between classes. Many of the terms used by WMI map fairly well to the 

6 relational database concepts. However, WMI offers features that a relational database 

7 does not offer, and vice versa. For example, unlike standard relational databases, WMI 

8 can retrieve instances of classes either by reading the repository ( a persisted description 

9 of the objects WMI manages), or by calling a COM object to retrieve the information 

is 

m 10 directly. Other generic software components that properly interface between WMI 204 

Si 

H 11 and a suitable schema could be used instead of provider(s) 205 . Output of provider(s) 

W 12 205 is shown operatively coupled to RAID++ 206. RAID++ 206 is a proprietary schema 

13 written in C++. Other generic schemas in C++ language that would appropriately 

Jff 14 interface between providers 205 and flare code 207 could be used. The output of 

□ 15 RAID++ 206 is provided via bidirectional bus 212 to proprietary flare code 207. Flare 

16 code is the storage arrays' internal firmware containing detailed computer code. Flare 

17 code provides machine language input to disk array 105 via bidirectional bus 110 shown 

18 in both Figs 1 and 2. Other generic code which would be operable to provide appropriate 

19 machine language input to the disk arrays could be used. 
20 

2 1 In operation, first information, such as WBEM' s CIM/XML/HTTP, the preferred 

22 standard, from Client 101 is forwarded via bidirectional bus 108 into storage processor 

23 1 02 where it is received and operated upon by IIS server 201 . This server is not designed 

13 
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1 to recognize this preferred standard protocol input, although it does operate properly with 

2 HTTP. There are no components within IIS that allow translation or manipulation of 

3 such formatted input data in such a manner that it can be made sensible to the server. 

4 However certain filters can be used with IIS as shown by ISAPI filter 202 which is a 

5 generic filter in which one can specify a sequence by which specific filters provided 

6 within ISAPI 202 are run. (Although ISAPI filter 202 is shown in Fig. 2 as being 

7 subsequent to ES in terms of information flow fi-om Client 101, in reality such filter 

8 works with IIS at the time of arrival of input information on bus 108.) For example, a 

9 CIM filter can be selected from several filters to run first, whereupon this particular 

O 

2 10 preferred standard input information or packet is immediately determined to be 

11 appropriate for this server. Thereafter, between the functions represented by IIS 201 and 

m 12 ISAPI 202, this XML-fbrmat information is put into a structure enabling fiarther 

3 13 manipulation of that input. Structure into which such input is placed is either: (1) 

P 14 Document Object Model (DOM) which is an in-memory representation of XML data - it 

2 15 defines what attributes are associated with each object and how objects and attributes can 

^ 16 be manipulated, or (2) a Simple API for XML (SAX) which is an application 

17 programmer's interface used by programmers for accessing and extracting data in XML 

18 documents. Both structures will work, but the best mode now known uses SAX rather 

19 than DOM for various reasons including improved performance. SAX allows processing 

20 as a set of events whereby one can key off certain object attributes and perform a desired 

21 action, requiring minimal interaction with memory. Such a design does not pay a penalty 

22 of loading this information into memory, perusing through it, and then dumping it out of 

23 memory for each new input information received. Instead, through SAX, these inputs are 

14 
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1 processed as an actual stream of data, and SAX allows the filtering function to be based 

2 on publicly defined CIM "tags" located in headers of the information inputs. The IS API 

3 filter either accepts the tags, which will be well-formed and will allow build-up of the 

4 WMI call to be described, or it will reject the tags based on incorrect format which builds 

5 up an error response which is sent back to nS, also to be described. 
6 

7 WMI 204 is a Microsoft software component which uses Distributed Component 

8 Object Model (DCOM) which is an extension of Component Object Model (COM) to 

9 support objects distributed across a network. Unfortunately, however, this model was 

10 rejected by DMTF and therefore does not meet the WBEM standard. DCOM is thus not 

11 compatible with CIM/XML protocol However, embodiments of the present invention 

12 include translation of information in the CIM/XML protocol into the WMI protocol 

13 which connects properly with DCOM. This is accomplished in WMI translator 203 

14 located fimctionally within ISAPI filter 202. WMI 204 is a standard software component 

15 available from Microsoft company, and its output forms the input to proprietary 

16 component Provider(s) 205. Providers 205, in turn, provide input to RAID++ 206 which, 

17 in turn, provide input to Flare code 207, the machine language which talks directly to 

18 disk array 105. Of course, the reverse flow of information, from arrays 105 to Client 101 

19 also takes place, as when the disks are read or when operating state of the disks are being 

20 reported back to Client 101 under control of this management software. 

21 

22 To fiirther explain operation of the components within SPA 102, consider the 

23 following information flow example from Client 101 to Disk Drives 105 and vice-versa. 
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1 This example illustrates at a high level the operation of the IS API filter. It shows the 

2 CIM/XML/HTTP input received from IIS 201 which is passed into the filter. It shows 

3 how the filter makes a WMI call, how the result is parsed, and shows the response to be 

4 sent back to IIS 20 1 . The input to translator 203 from IIS 20 1 is as follows: 



9 , 

10 

11 <?xml version="1.0" ?> 

12 <CIM CIMVERSION="2.0" DTDVERSION="2.0" > 

13 <MESS AGE ID="877" PROTOCOLVERSION=" 1 .0" > 

14 <SIMPLEREQ> 

1 5 <IMETHODCALL NAME=" Getlnstance " > 

16 <LOCALNAMESPACEPATH> 

17 <NAMESPACE NAME="root" /> 

18 </LOCALNAMESPACEPATH> 

19 <IPARAMVALUE NAME="InstanceName" > 

20 <INSTANCENAME CLASSNAME="EMC_StorageSystem"> 

2 1 <KEYBINDING NAME=" CreationClassName"> 

22 <KEYVALUE 

23 VALUETYPE="string">EMC_StorageSystem</KEYVALUE> 

24 </KEYBINDING> 

25 <KEYBINDESfGNAME="Name"> 



<KEYVALUEVALUETYPE="string">Test_array</KEYVALUE> 



5 



6 
7 
8 



TABLE I 



CIM/XML/HTTP INPUT TO TRANSLATOR 203 



27 



29 



28 



30 
31 

32 
33 
34 
35 
36 
37 
38 
39 
40 



</KEYBINDING> 
</INSTANCENAME> 
</IPARAMVALUE> 

<IPARAMVALUE NAME="IncludeQualifiers" > 



<VALUE>FALSE</VALUE> 
</IPARAMVALUE> 

<IPARAMVALUENAME="LocalOnly" > 



<VALUE>FALSE</VALUE> 
</IPARAMVALUE> 

<IPARAMVALIJE NAME="IncludeClassOrigin" > 



<VALUE>FALSE</VALUE> 
</IPARAMVALUE> 
</IMETHODCALL> 



</SIMPLEREQ> 



16 



Assignee docket No: EMC-01-027; Attorney docket No. JW-EMC-008 



PATENT 



1 </MESSAGE> 

2 </CIM> 

3 ^ , 

4 
5 

6 The above CIM/XML call in Table I (input to translator 203) is converted to the 

7 following WMI call in the ISAPI Filter which is output from translator 203 and is input to 

8 WMI 204: 
9 

10 

11 TABLE n 

12 

13 WMI CALL OUTPUT FROM TRANSLATOR 203, INPUT TO WMI 204 

14 

15 // Using the locator, connect to CIMOM and set the given namespace. 

16 BSTR pNamespace = _bstrJ("\\\V\\root\\cimv2"); 
17 

18 if(pIWbemLocator->ConnectServer(pNamespace, 



19 NULL, //using current account for simplicity 

20 NULL, //using current password for simplicity 

21 OL, //locale 

22 OL, // securityFlags 

23 NULL, // authority (domain for NTLM) 

24 NULL,// context 

25 &m_pIWbemServices) = S_OK) 
26 



27 // Set the class name 

28 CComBSTRbstr_className("EMC_StorageSystem"); 

29 lEnumWbemClassObject ^pEnumStorageDevs = NULL; 
30 

31 

32 // Get the list of instances. 

33 HRESULT hRes m__pIWbemServices->CreateInstanceEnum( 



34 bstr_className, // name of class 

35 0, 

36 NULL, 

37 &pEnumStorageDevs); // pointer to enumerator 



38 

39 

40 

41 // Now enumerate through the returned devices and find "Test_array" 

42 

43 IWbemClassObject ^pStorageDev = NULL; 
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1 hRes = pEnumStorageDevs->Next( 



2 2000, // timeout in two seconds 

3 1 , // return just one storage device 

4 &pStorageDev, // pointer to storage device 

5 &uRetumed); // number obtained: one or zero 

6 

7 if (SUCCEEDED(hRes) && (uReturned -= 1)) 

8 { 

9 VARIANT pVal; 

10 VariantClear(&pVal); 

1 1 // Get the "_RELP ATH" system property. 

12 BSTR propName = SysAllocString(L"_RELPATH"); 
13 

14 hRes = pStorageDev->Get( propName, // property name 

15 OL, 

16 &pVaiy/ output to this variant 

17 NULL, 

18 NULL); 
19 

20 // Done with this object. 

21 if (pStorageDev) pStorageDev->Release(); 

22 

23 // Add the path property to the output list. 

24 if (SUCCEEDED(hRes)) 

25 outputList.AddTail(CString(V_BSTR(&pVal))); 

26 } 

27 

28 

29 The above WML call in Table II which is output from Translator 203 is input to 



30 WMI 204. A typical output from WMI 204 which is input back into translator 203 is 

3 1 shown in Table III. 

32 

33 

34 TABLE m 

35 

36 OUTPUT FROM WMI 204, INPUT TO WMI TRANSLATOR 203 

37 

38 

39 void WriteXmlString(PHTTP_FILTER_CONTEXT pfc, char *buffer) 

40 { 

41 DWORD bufferLength; 

42 bufferLength = strlen(buffer); 

43 WriteClient(pfc, buffer, 

44 ^bufferLength, 0); 

45 } 
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1 void WriteProperties(PHTTP_FILTER_CONTEXT pfc, CList& properties) 

2 { 

3 POSITION pos = properties.GetHeadPositionO; 

4 if (pos) { 

5 WriteXmlString(pfc, ••<C1M CIMVERSION=\"2.0\" DTDVERSION=\"2.0\">"); 

6 WriteXmlString(pfc, "<MESSAGE ID="877" PROTOCOLVERSlON=\"1 .0\">"); 

7 WriteXmlString(pfc, "<SII\/IPLERSP>"); 

8 WriteXmiSlring(pfc, "<ll\/IETHODRESPONSE NAME=V"Getlnstance\">"); 

9 WriteXmlString(pfc, "<|RETURNVALUE>"); 

10 WiiteXmlString(pfc, "<INSTANCE CLASSNAI\/IE=\"EI\/IC_StorageSystem\">"); 
11 

12 // now write out the properties 

13 int i; 

14 for (int i=0;i < myList.GetCountO;i++) 

15 BSTR propName = properties.GetNext(pos); 

16 BSTR propValue = properties.GetNext(pos); 

17 

18 WiiteXmlSlring(pfc,CStringC'PROPERTY NAME=\"") + CString(propNanne) 

19 + CStringrTYPE=\"string\" <VALUE>") + CString(propValue) + 

20 CStri ng("<A/ALUE></PROPERTY>")) ; 
n 21 } 

i; 22 WriteXmlString(pfc, "</INSTANCE"); 

23 WriteXmlString(pfc, "</| RETURN VALUE"); 

^ 24 WriteXmlString(pfc, "</IMETHODRESPONSE"); 

'"^^ 25 WriteXmlString(pfc, '•</SlMPLERSP"); 

M 26 WrlteXmiString(pfc, "</MESSAGE"); 

fU 27 WriteXmlString(pfc, "</CIM"); 

ro 28 } 

Ni 29 . 

=_ 30 

2 32 Finally, the output from Translator 203 corresponding to the Table III input to the 

^ 33 translator from WMI, and which is input back to Client or UI 101 via busses 108 and 107 

34 is shown below in Table IV. 



35 

36 TABLE rV 

37 

38 CIM/XML/HTTP OUTPUT FROM TRANSLATOR 203 

39 . 

40 

41 <CIM CIMVERSION="2.0" DTDVERSION="2.0"> 

42 <MESSAGE ID="877" PROTOCOLVERSION=" 1.0"> 

43 <SIMPLERSP> 

44 <IMETHODRESPONSE NAME="GetInstance"xiRETURNVALUE> 

45 <INSTANCE CLASSNAME="EMC_StorageSystem"> 
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1 <PROPERTYNAME="Interconnect" 

2 TYPE=" string"><VALUE>Fibre<A^ALUE></PROPERTY> 

3 <PROPERTY NAME="CreationClassName" 

4 TYPE="string"><VALUE>EMC_StorageSystem</VALUE></PROPERTY> 

5 <PROPERTYNAME="Name" 

6 TYPE="string"><VALUE>Srirams_array</VALUE></PROPERTY> 

7 <PROPERTY. ARRAY NAME="Roles"TYPE="string"> 

8 <VAHJE.ARRAY> 

9 <VALUE>Block Server<A^ALUE> 

10 </VALUE.ARRAY> 

11 </PROPERTY.ARRAY> 

12 <PROPERTYNAME=" Status" TYPE="string"> 

13 <VALUE>Normal</VALUE> 

14 </PROPERTY> 

15 <PROPERTYNAME="Caption" TYPE="string"> 

16 <VALUE>Storage System Test_array</VALUE> 

17 </PROPERTY> 

^, 18 <PROPERTYNAME="Description" TYPE="string"> 

19 <VALUE>Storage System Test_array</VALUE> 

m 20 </PROPERTY> 



\l 21 </INSTANCE> 

H 22 </IRETURNVALUE> 

ni 23 </IMETHODI^SPONSE> 

m 24 </SIMPLERSP> 

^ 25 </lV[ESSAGE> 

U 26 </CIM> 

y 27 



S 28 

29 Figure 3 - Flowchart 

30 Referring next to Fig, 3 which illustrates the algorithm implemented by 

3 1 embodiments of the present invention, it starts with data being received by a Web Server, 

32 e.g. IIS 201, from a client, e.g. UI 101 in step 301. This data or information is presented 

33 in a particular protocol and is compared with, or applied to, a particular CIM/XML fiher 

34 in step or decision block 302. In that manner, a determination is made regarding whether 

35 or not such received data is valid CIM/XML data. If the answer is "no", the algorithmic 

36 process moves to step or process block 303 where an CIM/XML error response is built; 
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1 from there it moves to block 304 where the error response is returned the web server and 

2 awaits next data input from the UI. But, if the answer to the query in block 302 is "yes", 

3 then the algorithmic process moves to step or block 305 where a WMI method call is 

4 created, (e,g,, with respect to the prior code example, by operating on contents of Table 

5 I). The algorithmic process moves from there to decision block 306 where a query is 

6 made: issue WMI method call to WMI? If such method call is not issued (for reasons 

7 later discussed in connection with Fig. 4), an error response is built in step 310 and 

8 forwarded to step or block 309, about which detail is presented hereinbelow. But, if such 

9 method call is issued (e.g., with respect to the prior code example, contents of Table II 

10 forwarded to WMI 204), the algorithmic process moves to block 307 where WMI 

11 processes the method call (e.g., with respect to the prior code example, contents of Table 

12 III returned to Translator 203). The algorithmic process moves next to block 308 where a 

13 valid CIM/XML response is created from processed WMI method call. From there, the 

14 algorithmic process moves next to block 309 where such response is returned to the Web 

15 Server (e.g., with respect to the prior code example, contents of Table IV is returned). As 

16 noted above, step 309 also receives the error response that was built-up in step 310 and 

17 also returns such error response to the Web Server. The algorithm then stops and awaits 

18 the next data input at step 301 . 

19 

20 The function represented by decision box 302 could be multiple protocol filters, 

21 e.g. CGI filter, CIM/XML filter, SOAP filter, etc., where the storage system could be 

22 prepared to handle virtually any protocol extant. Or, alternatively, the Sanction 

23 represented by decision box 302 could be a single filter which could be manually 
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1 changed to a different single filter depending on which application or protocol is of 

2 immediate interest to the user. 

3 

4 Figure 4 - Flowchart blocks 305/306 

5 This flowchart illustrates the steps performed in blocks 305 and 306 of Fig 3 in 

6 creating and issuing the WMI method call In step 401, the default CIM namespace 

7 context is set. Accordingly, this default location is set. This is the memory location to 

8 which the WMI CIMOM (Windows Management Instrumentation Common 

9 Information Model Object Manager) looks, in order to access its common information 

10 objects. If the common information model namespace is not set, CIMOM would not be 

11 able to locate the desired CIM object being sought, CIM takes an object-oriented 

12 approach to modeling information. Management information is expressed using, at least, 

13 class definitions, inheritance, instances, properties, and methods. CIMOM is software 

14 functioning as an object manager responsible for handling requests for these classes. 

15 Thus, there is a single service with a well defined mechanism for accessing CIM objects. 

16 The algorithmic process next moves to step 402 where connection is made to WMI 

17 CIMOM. Thereafter, the algorithmic process next moves to step 403 where the CIM 

18 classname is set to query. This means that the classname which is to be looked-up shall 

19 be added to the WMI application programmer's interface (API) call, in order to retrieve 

20 CIM data. The algorithmic process next moves to step 404 where a buffer is created to 

21 hold the data returned fi^om the WMI call In step 405, a WMI call is issued to enumerate 

22 instances based on classname which means that the WMI API call is actually made. The 

23 algorithmic process next moves to decision block 406 wherein the query is made: was the 
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1 WMI call successful? The call could be unsuccessful for various reasons such as, for 

2 example, classname does not exist, or provider is not installed. If the answer to the query 

3 is "no", step 407 returns an error response to block 309, but if "yes" the algorithmic 

4 process next moves to step 307 where WMI processes the method call, as detailed in the 

5 discussion regarding Fig. 3. 
6 

7 Figure 5 - Flowchart blocks 308/309 

8 This flowchart details steps illustrated by blocks 308 and 309 in Fig 3 and which 

9 are associated with code illustrated in Table III Step 501 is initiated upon receipt of its 
^ 10 input from block/step 307 of Fig. 3. In step 501 a list of WMI data received in making 

11 the WMI call is parsed. Next, in step 502, the HTTP header is appended to the parsed 

;| 12 list. Finally, in step 503, the list of WMI data is appended into correct position to allow 

" 13 completion of CIM/XML response. Thereafter the algorithmic process moves to step 504 

m 14 where it returns to server (IIS) and stops. 




16 The present embodiments are to be considered in all respects as illustrative and 

17 not restrictive. In a particular configuration in which principles of the present invention 

18 are implemented, the operating system is Microsoft's Windows 2000, the language used 

19 is C++, the hardware used is an Intel-based model PHI 500 mhz PC computer supplied by 

20 vendor, Dell Corporation, and the storage system used is an EMC CLARiiON model 

21 FC4700 Disk Array. Other hardware and software can be combined to form systems in 

22 which the present invention can be implemented. The scope of the invention is indicated 

23 by the appended claims rather than by the foregoing description, and all changes which 
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come within the meaning and range of equivalency of the claims are therefore intended to 
be embraced therein. 
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